home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / songs26.zip / SONGS.DOC < prev    next >
Text File  |  1993-03-22  |  13KB  |  251 lines
  1.  
  2.         One of the Livewire Collection of multi-BBS Doorware programs.
  3.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  4.           UltraBBS, Telegard, TriTel, TriBBS, Remote Access, and WWIV
  5.  
  6.                                 Richard Paquette
  7.                                    PO Box 416
  8.                               Mt. Laurel, NJ 08054
  9.  
  10.                            (c) Copyright 1989 - 1993
  11.                               All Rights Reserved
  12.  
  13. IMPORTANT NOTICE TO REGISTERED SYSOPS!
  14.  
  15.  Once this door is registered, you can get "songutil.exe" which will
  16.  allow you to add all the questions and answers you want to the existing
  17.  data files. If larger data files have been created for Songs, then you
  18.  will have access to them also in the door specific conference on The
  19.  Livewire BBS.
  20.  
  21.                       Additional Line(s) to the CFG file
  22.                       ----------------------------------
  23.                        
  24.                         Line 5 <=- Registration number
  25.                         Line 6 <=- Number of songs allowed
  26.                                    each time in the door.
  27.  
  28.                   Example configuration file for PCBOARD.SYS
  29.                   ------------------------------------------
  30.                                                                              
  31. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  32. The Livewire BBS    <=-  (Change this to your BBS name)
  33. Richard             <=-  (The Sysop's first name)
  34. Paquette            <=-  (The Sysop's last name)
  35.  
  36. Example configuration file for USERS.SYS
  37. ------------------------------------------
  38.                                                                              
  39. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  40. The Livewire BBS    <=-  (Change this to your BBS name)
  41. Richard             <=-  (The Sysop's first name)
  42. Paquette            <=-  (The Sysop's last name)
  43.  
  44. Example configuration file for DOOR.SYS
  45. ---------------------------------------
  46.                                                                              
  47. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  48. The Livewire BBS    <=-  (Change this to your BBS name)
  49. Richard             <=-  (The Sysop's first name)
  50. Paquette            <=-  (The Sysop's last name)
  51.  
  52. Example configuration file for USERINFO.DAT
  53. -------------------------------------------
  54.                                                                              
  55. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  56. The Livewire BBS    <=-  (Change this to your BBS name)
  57. Richard             <=-  (The Sysop's first name)
  58. Paquette            <=-  (The Sysop's last name)
  59. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  60.  
  61. Example configuration file for CALLINFO.BBS
  62. -------------------------------------------
  63.                                                                              
  64. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  65. The Livewire BBS    <=-  (Change this to your BBS name)
  66. Richard             <=-  (The Sysop's first name)
  67. Paquette            <=-  (The Sysop's last name)
  68.  
  69. Example configuration file for DORINFOx.DEF
  70. -------------------------------------------
  71.                                                                              
  72. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  73.                           where 'x' is the BBS Node number.
  74. The Livewire BBS    <=-  (Change this to your BBS name)
  75. Richard             <=-  (The Sysop's first name)
  76. Paquette            <=-  (The Sysop's last name)
  77.  
  78. Example configuration file for SFDOORS.DAT
  79. ------------------------------------------
  80.                                                                              
  81. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  82. The Livewire BBS    <=-  (Change this to your BBS name)
  83. Richard             <=-  (The Sysop's first name)
  84. Paquette            <=-  (The Sysop's last name)
  85.  
  86. Example configuration file for CHAIN.TXT
  87. ----------------------------------------
  88.                                                                              
  89. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  90. The Livewire BBS    <=-  (Change this to your BBS name)
  91. Richard             <=-  (The Sysop's first name)
  92. Paquette            <=-  (The Sysop's last name)
  93.  
  94. Example configuration file for GTUSER.BBS
  95. ----------------------------------------
  96.                                                                              
  97. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  98. The Livewire BBS    <=-  (Change this to your BBS name)
  99. Richard             <=-  (The Sysop's first name)
  100. Paquette            <=-  (The Sysop's last name)
  101. 1                   <=-  (COM port number - defaults to 1)
  102. 1                   <=-  (Node number - defaults to 1)
  103. 123123              <=-  (Registration Number)
  104.  
  105. Example configuration file for TRIBBS.SYS
  106. ----------------------------------------
  107.                                                                              
  108. C:\BBS\TRIBBS.SYS   <=-  (Full pathname of your TRIBBS.SYS file)
  109. The Livewire BBS    <=-  (Change this to your BBS name)
  110. Richard             <=-  (The Sysop's first name)
  111. Paquette            <=-  (The Sysop's last name)
  112.  
  113. Example Batch File 
  114. -------------------
  115. A sample batch file is included and is similar to the following:
  116.    ECHO OFF
  117.    CD\DOORS                <=- Switch to the door's Directory.
  118.    DOOR DOOR.CNF           <=- Execute the door program and pass the
  119.                                 configuration filename to the program.
  120.    CD\PCB                  <=- Go back to PCB DIR when user exits door.
  121.    BOARD                   <=- Restart BBS.
  122.                                                                              
  123. This Door is multi-node  compatible so you may run more than 1 node from
  124. the same .CNF file  provided the path to your system file (DORINFOx.DEF,
  125. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  126. variables, (q.v.)
  127.  
  128.                          Environment Variables
  129.  
  130. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  131. variables. Non-PCBoard systems may also use these variables by including
  132. the following in either your BBS batch or AUTOEXEC.BAT
  133.  
  134.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  135.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  136.  
  137. Then in your Door .CNF file instead of putting C:\BBSDIR\DOOR.SYS, you
  138. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  139. .CNF file for multi-node operation!
  140.                                                                              
  141. To specify a non-standard IRQ, put the IRQ number after the .CNF on the
  142. command line.  For example:
  143.                                                                              
  144.      DOOR DOOR.CNF /5
  145.      or using the PCBDRIVE procedure: SET IRQ=5 and use
  146.      DOOR DOOR.CNF /%IRQ%  
  147.                                                                              
  148. This tells the program to use IRQ 5 instead of the standard IRQ.
  149.  
  150.                            Top Ten Bulletin
  151.                            ----------------
  152.                                                                              
  153. The first time you run this door online it will create 3 files called
  154. ****.BUL, ****.BLT and ****.BLT. If you  wish to change the path
  155. or filename of the  Bulletin,  you must edit  ****.BUL and  change the
  156. first line to whatever path/filename you desire, assuming that this door
  157. requires or has a bulletin to display.. these docs are generic for all
  158. The Livewire Doors and some of them DO NOT create a bulletin.
  159.  
  160.                               Sysop Keys
  161.                               ----------
  162.  
  163. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  164.          written to DOOR.SYS and USERS.SYS
  165. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  166.          and/or written to DOOR.SYS and USERS.SYS
  167. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  168. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  169.          and/or written to DOOR.SYS and USERS.SYS
  170. F8    -  Returns the caller involuntarily to the BBS.
  171. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  172.          and/or written to DOOR.SYS and USERS.SYS
  173. F10   -  Activates SysOp CHAT mode within the DOOR.
  174. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  175. UP    -  Give the caller extra time while in the DOOR.  
  176. DN    -  Subtract time from the caller while in the DOOR. 
  177. HOME  -  HELP key for Status Line options.
  178. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  179. ALT-X -  PCBoard will exit after current caller logs off. Value is
  180.          passed to PCBoard. Not available on non-PCBoard systems.
  181.  
  182.                              Distribution
  183.                              ------------
  184.                                                                              
  185. This program is being distributed via the SHAREWARE concept and as such,
  186. may be copied freely with the following restrictions:
  187.                                                                              
  188.         * The program must be supplied in it's original unmodified
  189.           form, including documentation.
  190.                                                                              
  191.         * This program may not be distributed as part of any commercial
  192.           application or service without the express, written consent
  193.           of the author.
  194.                                                                              
  195.         * Vendors of Shareware/Public Domain software may not
  196.           distribute this program without the express, written
  197.           consent of the author even if Vendor has been approved
  198.           by the Association of Shareware Professionals (ASP).
  199.  
  200.                              Registration
  201.                              ------------
  202.                                                                              
  203. This door represents  many hours of  programming and the author deserves
  204. just compensation for his time, efforts and expertise.  If you find this
  205. program to be of some  value and you  continue to use it on your system,
  206. you must return the order form provided along with the registration fee.
  207. Registration  entitles you to  free upgrades via  modem from  The Livewire
  208. BBS Support Conference.  Payments should be  made in the  form of a check or
  209. money order. Foreign orders must be in U.S. funds drawn on a U.S. bank.
  210.  
  211. Online registration with Visa or Mastercard is available via our Credit
  212. Card Door at the following system:
  213.                                                                              
  214.                   The Livewire BBS: (609) 235-5297 HST
  215.                                                                              
  216. NOTE: If you register by mail,  your registration number will be posted
  217.       in a private message on The Livewire BBS. 
  218.  
  219.                                Copyright
  220.                                ---------
  221.                                                                              
  222. This door is Copyrighted(c) 1989-93 by Richard Paquette, and is distributed
  223. as Shareware. Under this concept you may use the SHAREWARE (unregistered)
  224. version for a  reasonable period of  time for evaluation  after which you
  225. must either register your copy or discontinue  usage.
  226.  
  227.                                Warranty
  228.                                --------
  229.                                                                              
  230. This product is provided as is without warranty of any kind.  The entire
  231. risk as to the results and performance of the program is assumed by you.
  232. Futhermore, the  author does not warrant, guarantee, or  make any  other
  233. representations regarding the use of,  or the  results of the use of the
  234. program,  and you rely on the  program and  results  solely at  your own
  235. risk.  The author  cannot and will not accept  responsibility for system
  236. damage, loss of profit or any other special, consequential or incidental 
  237. damages  resulting  from  the use of or inability to  use this  product.
  238.  
  239.                                Com-Ports
  240.                                ---------
  241.  
  242.                    DoorFrame now supports COM 0 thru 15.
  243.  
  244.                              Fossil Drivers
  245.                              --------------
  246.                                                                              
  247. This door may be used with Fossil drivers such as X00 & BNU.  This makes
  248. it compatible  with most  multi-port  boards.  To use the Fossil  driver
  249. instead of the standard COM ports, include  /FD on the command line when
  250. running the door. For example: DOOR DOOR.CNF /FD
  251.